package com.mercycrazy.springframework.beans.factory;

import com.mercycrazy.springframework.beans.BeansException;

import java.util.Map;

/**
 * 对 {@link BeanFactory} 接口的扩展，由可以枚举所有Bean实例的Bean工厂来实现，
 * 而不是按照客户的要求一个一个地尝试查找Bean的名字。
 * 预加载所有Bean定义的BeanFactory实现（例如基于XML的工厂）可以实现这个接口。
 *
 * @author <a href="mailto:1443424326@qq.com">mercycrazy</a>
 * @since 2022-11-26
 */
public interface ListableBeanFactory extends BeanFactory {

    /**
     * 按照类型返回 Bean 实例
     *
     * @param type Bean 类型
     * @param <T>  泛型
     * @return 符合要求的 Bean
     * @throws BeansException Bean 不存在，抛出异常
     */
    <T> Map<String, T> getBeansOfType(Class<T> type) throws BeansException;

    /**
     * @return 返回注册表中所有的 Bean 名称
     */
    String[] getBeanDefinitionNames();
}
